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Moving From 3.x to 4.0 


1.1. Advantages of 4.0 SunOS 4.0 provides new functionality and features not available in SunOS 3.x 

releases. For a detailed discussion of changes, refer to the 4:0 Change Notes 
chapter of this document. 

Key improvements incorporated by SunOS 4.0 include: 

□ New system architecture that promotes system resource sharing and portabil¬ 
ity across different hardware platforms. 

□ Shared library facility that reduces program size and swap space require¬ 
ments. 

o Resizable swap area for diskless clients. 

□ Secure networking through the use of RPC (Remote Procedure Call). 

□ NFS (Network File System) replaces ND (Network Disk) for diskless client 
systems. The effect of this is to make system administration easier and more 
flexible. 

□ All the 4.3BSD network changes are incorporated including TCP (Transmis¬ 
sion Control Protocol) and IP (Internet Protocol) perfomiance improvements 
and subnetting. 

□ Automount facility that automatically mounts accessible remote filesystems 
as needed. 

1.2. Install vs Upgrade Moving from SunOS 3.x to 4.0 cannot be accomplished through a standard 

upgrade procedure, but requires a re-installation of the entire system. 

In a standard upgrade, you selectively replace files in each architecture. Due to 
the filesystem reorganization that separates host-dependent, nonshared files from 
architecture-dependent, shared files, selective replacement of files is not possible. 
The only way to incorporate the SunOS 4.0 enhancements is to re-install the 
entire system. 

The new SunOS 4.0 filesystem organization is transparent to most users and 
simplifies the administration of diskless clients. The new filesystem layout also 
makes it easier for many clients of different architectures to work with a single 
server. 
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In general, the migration from 3.x to 4.0 is recommended. As with any release, 
however, there are isolated differences that require special consideration before 
migration to the new release. Review the following items and consider their 
impact to your site before migrating to SunOS 4.0. 

o If you install the entire SunOS 4.0 system, it requires more disk space. 

Unnecessary modules should be removed from your system to optimize disk 
usage. For more information regarding required disk space, see Appendix B 
of Installing the SunOS. 

□ The SunOS 4.0 kernel must be reconfigured to realize SunOS 3.x perfor¬ 
mance levels. A reconfigured kernel optimizes memory usage and is prefer¬ 
able to the GENERIC kernel. 

□ Programs compiled with pre-SunOS 4.0 releases should be recompiled to 
take advantage of new SunOS 4.0 enhancements such as shared libraries. 

□ Source code changes may be required for modules that use changed or 
obsoleted library and system calls. 

Installing SunOS 4.0 For information regarding the installation of SunOS 4.0, see Installing the 

SunOS. 


1.3. Issues to Consider 
Before Moving to 
4.0 
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2.1. Introduction 


Compatibility 


SunOS 4.0 Change Notes 


This document highlights the changes and enhancements contained in SunOS 4.0 
that were not available in the SunOS 3.x releases. All users migrating from a 
SunOS 3.x release should read this document. For new users this is not as criti¬ 
cal, however it may be helpful in noting the most current advances in SunOS. 

The change and enhancement descriptions in this document are summaries. For 
more in-depth information see the suggested documentation. 

SunOS 4.0 software runs on Sun-2, Sun-3, and Sun-4 systems. As with any major 
release, there are compatibility issues with previous releases. The compatibility 
issues for SunOS 4.0 are discussed below. 

NOTE Pre-SunOS 4.0 object files should not be used with SunOS 4.0. This means that 

all . o and . a files built under previous systems must be recompiled prior to 
their use under SunOS 4.0. 

o All binary or source code developed on a Sun-3 under SunOS 3.x runs on a 
Sun-3 under SunOS 4.0 with the following exceptions: 

Programs that depend on system file locations that have changed, and a 
symbolic link was not left behind. 

Programs that read kernel data structures via /dev/kmem or 
/dev/mem. 

Programs that use the current mmap system call require minor source 
changes due to the new VM system, however, existing binaries work. 

Programs that depend on the "unmap on close" semantics of the iranap 
system call in the old system will not run under SunOS 4.0. 

Almost any customer written kernel code will require changes. 

Any code that uses the LTILDE flag or the t_dsuspc interrupt char¬ 
acter must be changed due to the new System V/BSD-compatible tty 
driver. 

Upgrading to the 4.3BSD networking system has introduced the follow¬ 
ing incompatibilities: ioctls for looking at the network 
configuration, socket process group handling, the interface to the set- 
sockopt call. 
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The NIT facility has changed and the interface is different. It now 
requires a source change for customers to write to this level. 

Programs with embedded executable names may fail due to the file sys¬ 
tem reorganization. 

□ Programs that use getpwent () and associated routines should be rebuilt 
in SunOS 4.0 or they may not work correctly in a C2 secure environment. 

□ Programs written with the previous signal-handler function type continue to 
function properly but, there will be new compiler and lint messages. The 
messages warn that the code does not conform to standard, but are harmless. 

□ init no longer uses /et c/ttys so any administrative procedures that 
modify it must be changed to modify /et c /ttytab instead. 

□ The syslog facility has been upgraded to be compatible with 4.3BSD. 

For a discussion of the incompatibilities, see the sy slog compatibility 
under the 4.3BSD Enhancements section of the System Software Changes in 
this document. 

□ Due to driver, loader, and PROM attributes associated with the QIC24 high 
density tape, SunOS 4.0 only loads when the system has a PROM revision of 
1.8 or greater. See QIC 24 PROM under the System Software Changes sec¬ 
tion of this document for more information. 

o Source calls to get dirent ries must be changed to calls to the new 
get dents system call. It is not sufficient to simply replace a get- 
direntriesO call with a getdents call. It must be converted. 

Availability of Sun 
Unbundled Software 


Most of Sun’s unbundled products are being revised to take advantage of the 
functionality introduced with SunOS 4.0. With the exception of the core com¬ 
pilers and communications products, many of the existing versions work with 
SunOS 4.0. The following chart titled "Sun Unbundled Software Availability" 
provides information on availability of Sun’s unbundled software for releases 
3.x and 4.0. Note that versions designed to take full advantage of SunOS 4.0 
generally support the Sun-2, 3, and 4 platforms. Contact you local sales 
representative for specific product availbility information. 
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Table 2-1 Sun Unbundled Software Availability 

Unbundled Software Availability 


os and 

Platfrom 

SunOS 3.x 
Sun-2,3 

Sun-4 

SunOS 4.0 
Binary 

Compatibility 

SunOS 4.0 
Full 

Functionality 

Product 

News 

1.1 

1.1 

1.1 

1.1 

SunGKS 

2.1 

2.1 

2.1^ 

t 

Sun FORTRAN 

1.0 

1.05 

— 

1.1 

Sun Cross-Compilers 

2.0 

2.0 

— 

2.1 

Sun Pascal 

— 

1.05 

— 

1.1 

NSE 

1.0 

1.05 

— 

1.1 

SunTrac 

1.0/1.1 

1.0/1.1 

1.0/1.1 

1.2 

PC-NFS 

3.0 

3.0 

3.0^ 

3.0 

SunIPC 

1.1 

— 

5.0/5.1* 

t 

SunlNGRES 

5.0/5.1 

— 

6.0 

SunUN IF'Y/SunSimplily 

3.0 

3.0 

3.0‘ 

3.0 

SimAlis 

2.1 

— 

2.1 

t 

Sun Common Lisp 

2.1 

2.1 

— 

t 

SPE 1.0 forSCLisp 

2.1 

2.1 

— 

t 

Sun Modula-2 

2.0 

— 

2.0^ 

2.1 

Transcript 

2.0 

— 

2.0^* 

2.1 

X.25 

5.0 

5.1 

— 

6.0 

DNI 

5.0 

5.1 

— 

6.0 

SNA 3270 

5.0 

5.1 

— 

6.0 

TEIOO 

4.0 

5.1 

— 

6.0 

IR 

5.0 

— 

— 

6.0 

BSC 3270 

3.0 

— 

— 

6.0 

Channel 

5.0^ 

— 

— 

6.0 

Local 3270 

5.0^ 

— 

— 

6.0 

DDN 

5.0 

— 

— 

6.0 

MCP 

5.0^ 

— 

— 

6.0 

SCP 3.0 

3.0 

— 

— 

6.0'* 

OSl 5.0 

5.0 

— 

— 

6.0 

SNA Peer 5.0 

5.0 

— 

— 

6.0 

MRS 5.1 

5.1 

— 

— 

6.0 


^ Announcement pending. 

* Restricted to ranning existing applications. 

^ Availability of PC-NFS support for serial lines under SunOS 4.0 to be announced later. 

^ Minor changes needed for the Modula-2 libraries. Documented in Software Tedinical Bulletin. 
^ Sun-2,3 only. 

* Sun-3 only. 

* Local 3270 gateway mns only on Sun-3; Local 3270 client runs on Sun-2 and Sun-3. 


sun 
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Software support is available for the following new hardware: 

□ The Sun-4 Workstation 

□ SCSI 1/2 Inch Tape Support 

□ Xylogics 7053 VME SMD Disk Controller 

There is a new driver for the Xylogics 7053 SMD disk controller called XD. 
Up to four controllers are supported in a system with a vme bus. Up to four 
disks are supported per controller. 

□ Sun Type-4 Keyboard 

The keyboard is compatible with aU Sun-2, Sun-3, Sun-4 and Sun386i 
workstations. 

For information on Sun-4 power-up procedures, tests and PROM monitor com¬ 
mands, and EEPROM programming procedures, refer to the PROM User’s 
Manual in the System Administration Docubox. 


This section covers the significant changes and upgrades to system software for 
SunOS 4.0. 

New Kernel Architecture The SunOS 4.0 kernel is significantly restructured to accomodate a new virtual 

memory management scheme. This scheme promotes system resource sharing 
and portability across diverse hardware platforms. 

Swap space requirements are generally reduced and system resources are used 
more efficiently. Caching of frequently accessed data is more efficient and files 
are treated as part of virtual memory, making access to large files more con¬ 
venient and efficient. 

Diskless NFS Server SunOS 4.0 handles support for diskless client systems through NFS (Netwoik 

File System) rather than ND (Network Disk) mechanism. The migration to 
NFS-supported diskless nodes offers the following benefits: 

□ Easier maintenance of servers and clients 

□ Easier mixing of remote and local filesystems 

□ Cleaner support of multiple architectures 

□ Minimal disraption to existing programs 

□ Minimal symbolic link confusion 

Support of heterogeneous environments is improved since implementations of 
the diskless NFS server are available on non-Sun servers. A diskless Sim works¬ 
tation is now able to boot and swap off a non-Sun server. 

Eliminating ND does not affect the number of clients a server can support. No 
PROM change is required for Sun-2 systems that do not support t ftp booting, 
since a user-level boot block server is provided. 
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For complete information on the new filesystem layout, see Chapter 1 in Instal¬ 
ling the SunOS and System and Network Administration. Also refer to the fol¬ 
lowing man pages: hier(7) and filesystem(7). 


Filesystem Reorganization SunOS 4.0 includes a reorganization of the filesystem that simplifies the adminis¬ 

tration of diskless clients. The reorganization separates host-dependent, 
nonshared files from architecture-dependent, shared files. This filesystem layout 
makes it easier for clients of different architectures to work with a single server. 

AU files and directories that define the individual identity of the machine or are 
dedicated to the machine, (such as /etc/passwd) are now in /usr/etc. 
These include the spool directories from /usr/spool and the adm files from 
/usr/adm which are now in /etc/spool and /etc/adm respectively. 

Architecture-dependent files, including all executable files and libraries, have 
been moved to the /usr filesystem, /bin no longer exists and its contents 
are now in /usr/bin with a symbolic link left behind. The contents of /lib 
are in /usr/lib and all executables from /etc are now in /usr/etc. 

The new /usr is designed to be mounted read-only. Very few executable files 
are left in the root filesystem; these include: 

□ vmunix 
o init 

□ sh 

□ ifconfig 

□ hostname 
o mount 

AU executable files in the root directory, except vmunix are now located in the 
new /sbin directory. Because of the filesystem reorganization, /usr must 
be mounted even when booting into single user mode. 

See Installing the SunOS and System and Network Administration for more infor¬ 
mation. 

The optional automount facility automaticaUy mounts filesystems transparently. 
The automount command invokes a background daemon that intercepts directory 
references and mounts accessible remote filesystems as needed. Automatic 
dismounting occurs after a specified period of inactivity. Remote filesystem 
mounting uses YP (YeUow Pages) maps and local map files. 

Changes to boot Prior to SunOS 4.0, booting a stand-alone workstation or a server from a local 

disk was done through code in boot which accessed and interpreted a file sys¬ 
tem on a disk. 

The following changes have been made to boot in SunOS 4.0: 

□ ND code has been eliminated, since servers no longer support ND opera¬ 
tions. 


Automounting of Remote 
Filesystems 
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New Virtual Memory 
System 


Shared Libraries 


□ The boot (8) program now imderstands how to perform NFS file opera¬ 
tions over the net to a server with which the client woilcstation is registered. 

For a complete explanation of this see System and Network Administration (800- 
1733). 

The memory management facilities of SunOS have been completely replaced for 
4.0. The new implementation unifies the system’s operations on memory objects 
around the concept of file mapping. This treats processor memory as a very large 
cache of file pages. The affects of this change include the following: 

□ A fuUy implemented itimap system call supporting regular files in addition 
to a few character special devices. 

□ Changes in the system’s handling of memory sharing so that sharing occurs 
on the basis of single file pages, rather than entire program texts. 

□ A more general structure to the address space available to applications. 

For more information, see Chapter 5 of the System Services Overview. 

The system supports a shared libraries facility built upon a new dynamic linking 
capability and the file mapping facilities provided by the new virtual memory 
system. Shared libraries are constructed through the application of several 
changes to each of the following: compiler, assembler, and link-editing tools. 

SunOS 4.0 is integrally dependent on shared libraries. Almost every program in 
the release uses at least the shared C library. The window tools use shared ver¬ 
sions of the Suntools and Sunwindows libraries. 

Library sharing reduces program size and swap space requirements, and 
simplifies the incorporation of revisions to libraries. 

You can build your own shared libraries. 

The C compiler and assembler have been enhanced to generate position indepen¬ 
dent code (PIC) used to build shared libraries. 

SunOS 4.0 includes the following shared libraries: 

□ BSD and System V versions of libc 

□ 1 ibkvm for interpreting the kernel’s address space 

□ libsunwindow and libsuntool, the window system libraries 

□ libpixrect, the Pixrects library 

The archive (. a) form of these libraries are also included in SunOS 4.0. 

For more information, see Programming Utilities and Libraries. 



sun 

microsystems 
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Resizable Swap Area Resizing diskless client swap space no longer requires taking a server and its 

clients offline or reinstalling the system. Only clients whose swap space is 
being modified need to be halted. The resizing process is transparent to other 
clients. 

NIT Streams Instead of Sockets The Network Interface Tap is now available through the System V STREAM 

mechanism instead of the socket mechanism. A general packet filter is now pro¬ 
vided as well as a STREAM module. 

4.3BSD Enhancements The items in this section are enhancements from 4.3BSD in SunOS 4.0. 

Alternative Protocol Architectures The kernel can now be configured to support other protocols from a binary 

release without having to recompile the source to the Ethernet driver. This 
makes the installation of Sunlink products easier. 

/etc/ttys Compatibility The system uses a new style /etc/ttys file that is now called 

/etc/ttytab. init reads this new file and writes an /etc/ttys file 
with the same relative positions within the file for each tty. The /etc/ttys 
file written by init is read-only. Users are not allowed to modify it directly 
since doing so does not have any effect on init. /et c/ttys is rewritten 
whenever init reads /etc/ttytab. Sun programs written under previous 
releases stiU run compatibly with the /etc/ttys emulation. 

Since init no longer uses /etc/ttys, any administrative procedures that 
modify it must be changed to modify /etc/ttytab instead. 

The new /etc/ttytab file format is completely compatible with 4.3BSD, 
but the file name is different It is possible for /etc/ttys to be a symbolic 
link to /etc/ttytab (or vice versa) where complete 4.3BSD compatibility 
is required. Doing this, however, breaks compatibility with old Sun programs. 
See ttys (5) and ttytab (5) for more information. 

/etc/ttytab includes the information that used to be in /etc/ttytype 
and /etc/securetty. 

fsck (8) f sck (8) now creates and grows directories. This allows it to rebuild the root 

of a file system as well as create and enlarge the lost-i-f ound directory when 
necessary. 

FTP Fully Implemented The File Transport Protocol incorporates several new commands in SunOS 4.0. 

The default transfer type now is ASCII, so transfer of binary files requires an 
explicit command. See ftp(lc) and ftp (8c). 

Full ICMP Support Prior releases did not implement all of the ICMP (Internet Control Message Pro¬ 

tocol) which caused problems on multi-vendor networks such as the Defense 
Data Network. 
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Full IP Subnetting 


getty(8) 
inetd compatibility 


IP Options 

Line Printer Spooler 


login 


New Buffering Conventions 


The restrictions on IP subnets in Release 3.3 have been removed. In SunOS 4.0, 
each interface can have its own network mask. A new YP map 
netmasks .byaddr is used to enable subnets. 

getty (8) is upgraded to the 4.3BSD version. It now uses /etc/ttytab. 


The new inetd uses a different file format in a file of a different name 
(/etc/inetd.conf vs. /etc/servers). 

The new inetd uses different conventions to start the programs it runs. Previ¬ 
ously, inetd would call the program with a single argument which contained 
the port number the connection was on. In SunOS 4.0, inetd gets the port 
number by using getpeernameO- 

SunOS 4.0 inetd is completely compatible with the4.3BSD inetd. Pre¬ 
vious Sim programs should woik without change with the new inetd, as long 
as the /etc/ inetd. conf file is set up properly. For more information, see 
inetd.conf(5) and inetd(8c). 

inetd now supports selected Internet services internally, such as echo, day, and 
character generator. 

More general support is provided for options at the Internet level. 

The line printer daemon, Ipd (8), has 4.3BSD enhancements incorporated. 

Error logging is handled with the new syslog daemon. The 
/etc/hosts. Ipd file can be used to extend remote access. This is in addition 
to the /etc/hosts. equiv file. Various bug fixes have also been incor¬ 
porated both from 4.3BSD and customer reports to Sun. 

The other line printer support facilities, Ipr (1) and Ipc (8), have also been 
enhanced with the changes from 4.3BSD. These facilities include the up and 
down commands in Ipc (8), and the support for restricted access printing in 
Ipr(l). 

login is upgraded to the 4.3BSD version. When you log in, your terminal is 
changed to be owned by the tty group and has the rw—w -mode. Pro¬ 

grams such as write that write to other user’s terminals have been changed to 
run set-group-ID to group tty. These programs only permit printable ASCII 
characters and white-space characters to be written unchanged. This closes a 
security hole caused by permitting arbitrary programs to write to other user’s ter¬ 
minals. 

The kernel uses 4.3BSD conventions for handling mbuf structures within the 
socket system. Customer network drivers may need to be rewritten. 
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New Interface Structure 


passwd 


ps 


rep 


Socket Process Group IDs 


syslog Compatibility 


The kernel if net structure has changed as in 4.3BSD to allow more generality, 
such as the use of a single interface by several different address families. All 
Sunlink products require new releases for SunOS 4.0. 

passwd (1) is upgraded to the 4.3BSD version. It now permits you to change 
the full-name and login shell for your entry in /etc/passwd. 

NOTE These features are not present in yppasswd(l). You can change your pass¬ 

word in the Yellow Pages database, but not your full-name or login shell. 

ps (1 > is upgraded to the 4.3BSD version. By default, it now prints wait chan¬ 
nels in symbolic form, rather than numeric form. Many wait channels, such as 
the wait channel for a process blocked doing I/O on a stream (such as a terminal), 
do not have a symbolic name; they print out as kerneIma. 

Due to differences between the 4.3BSD and SunOS virtual memory implementa¬ 
tion the following conditions result: 

□ The -s flag is not supported. 

□ The ADDR field is not printed when the -1 flag is specified. 

□ The TSIZ and TRS fields are not printed when the -v flag is specified. 

□ When the -u flag is specified, the start time of the process is printed. 

□ The -r flag restricts the printout to processes that are running or sleeping 
on a fast wait (sleeping with negative priority). 

rcp(lc) is upgraded to the 4.3BSD version. This version no longer supports 
host/userid specifiers of the form host.user because domain-based hostnames can 
contain periods. 


The interpretation of the process and process group ID for a socket as set by the 
F_SETOWN fcntl operation or the lOCSPGRP ioctl operation has 
changed. 

Prior to SunOS 4.0 the 4.3BSD guidelines were as follows: 

□ A positive value was a process group ID. 

□ A negative value was a process ID. 

In SunOS 4.0, the 4.3BSD guidelines are as follows: 

□ A positive value is a process ID. 

□ A negative value is a process group ID. 


In SunOS 4.0, the syslog facility is now compatible with 4.3BSD. This 
results in the following incompatibilities: 

□ Pre-4.0 program logging to 4.0 syslog daemon 


Pre-4.0 programs log messages with no facility code but with priorities in 
the range 1-9. Since the 4.0 syslog accepts priorities in the range 0 - 
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syslog Daemon 


su 


7, priorities 8 (LOGJNFO) and 9 (LOG_DEBUG) look like priorities 0 
(LOG_EMERG) and 1 (LOG_ALERT) from facility 1 (LOG_USER). 
Unfortunately, this has the effect of making low priority messages seem to 
be much higher priority than they really are. 

Almost all of the values for logging levels have changed. This causes, 
for instance, messages logged at the old LOG_CRIT level to be logged at the 
new LOG_NOTICE level. In general, old log messages appear to be less 
important than intended. 

The 4.0 syslog daemon forces messages that claim to be from the 
LOG_KERNEL facility to look like they came from the LOG_USER facil¬ 
ity, unless they come from the local kernel. The syslog. conf file on 
the “loghost” machine is set up to log aU LOG_USER messages in the log 
file used to log LOG_MAIL messages. 

□ SunOS 4.0 program logging to pre-4.0 syslog daemon 

All SunOS 4.0 programs using syslog send their log messages to the 
local syslog daemon. The default 4.3BSD syslog configuration file 
causes all syslog messages to be logged in local files, although it does 
provide a facility to forward the syslog message on to a syslog dae¬ 
mon on another machine, sendmail log messages and “authorization 
system” log messages are forwarded to “loghost”. 

These forwarded messages include a facility code in their log message. 
Except for LOG_USERILOG_EMERG (== 8) and 
LOG_USERILOG_ALERT (== 9) (which, by default, are not forwarded to 
the syslog daemon at “loghost”), these all cause the priority field in 
the message to be two digits. The old syslog daemon does not under¬ 
stand multi- digit priority fields, and therefore logs the message with a 
default priority of LOG_ERR (== 4). Using the default configuration file, 
this causes the message to be logged with aU the sendmail log messages 
in /usr/spool/log/syslog. For more information, see sys¬ 
log (3) and syslogd(8). 

The syslog daemon has been upgraded to the 4.3BSD version. It reads kernel 
printf messages from a new device and logs them. Many system daemons 
have been changed to log to the syslog daemon as well. 


If the wheel group (group 0) has members, only they can su to root, even 
with the root password. Successful and unsuccessful attempts to su to root are 
logged to the syslog daemon. 
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tcopy(l) 

TCP Performance 


TCP Urgent Data 


tcopy(l) is a new tape copying program that preserves tape blocking. 

The TCP software now estimates the round-trip time as well as the variation of 
round-trip time. This provides for continuously good performance on both fast 
and slow netwoiics. 

The interpretation of TCP Urgent data has been changed to be closer to the 
official specification. 


Telnet Improvements The SunOS 4.0 telnet daemon supports terminal type negotiation. The 

telnet program now supports optional local X-ON^-OFF flow control. See 
telnet (Ic). 

tftp tftp(lc) is upgraded to the 4.3BSD version. The default transfer mode is 

now ASCII. To transfer to a non-ASCII file, binary mode must be explicitly 
selected. 

The SunOS TFTP server t f tpd is normally configured to run in a secure 
mode. This only allows for bootstrapping machines over the network and for 
transfers from the /1 f tpboot directory. TFTP should not be used for general 
file transfer operations unless the TFTP server on the remote machine is 
configured to permit this. As TFTP requests carry no access credentials, TFTP 
servers often do not permit general file transfers. Other mechanisms, such as 
FTP, rep, rdi st, or NFS, should be used to access files on remote machines. 

tftpd tftpd(8C) is upgraded to the 4.3BSD version. This version supports both net- 

ascii and binary transfer modes. 

In SunOS 4.0, the TFTP server also supports special modes that specially 
configure it to act solely as a bootstrap server for booting diskless machines over 
the network. By default, the TFTP server operates in this mode, which leaves it 
inoperable for general file transfer. It can be configured to run as a general file 
transfer service, but this can result in security problems as it allows any other 
machine on the network to retrieve any publicly-readable file. 

t set (1) is upgraded to the 4.3BSD version. It sets the terminal driver’s notion 
of the screen size from the number of columns and lines in the teirmcap entry 
for the terminal. The Sun console driver ignores this, however, so the size wiU 
be hardwired at the value configured in the PROM. 


2.4. General Software 
Changes 


This section covers the general software changes incorporated in SunOS 4.0 
under the following categories: 


n General Conceptual Changes 
□ System Call Changes 


□ General C Library Changes 
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General Conceptual This section covers the general conceptual software changes and enhancements 

Changes in SunOS 4.0. 


C Program Exit Status In a C program, if the main function main () returns, its return value is used as 

the exit status of the program. Previously, 0 was used as the exit status if 
main () returned; this change makes SunOS more compatible with 4.3BSD and 
System V. Note, however, that some erroneous programs do not return any 
value from main (). Thus, they can return a non-zero exit status. 

Filename Completion Filename completion is a new feature in SunOS 4.0. In addition to the wild card 

characters (?,*), the C shell provides a filename completion utility that tills in the 
rest of a filename after you type a few characters. 

To implement this feature, you need to include the following line in your 
. cshrc tile or type it on the command line: 


set filec 


Once included in your .cshrc tile, you can type in the tirst few letters of a 
tile’s name and the C shell will complete the rest for you. 

NOTE Currently, filename completion does not work in SunView command or text win¬ 

dows unless scrolling in that window is disabled. Filename completion works in 
shellt ool windows. See the SunView Beginner’s Guide for information on 
how to enable and disable scrolling. 

For more information on filename completion, see Doing More with SunOS: 
Beginner’s Guide. 

Group ID for Newly-Created Files The rules used to specify the group ID that own a newly created tile have 

changed in SunOS 4.0. Previously, the group ID for any newly-created tile was 
set to the group ID of the directory in which the tile was created. Now, if the 
set-GlD bit is not set on a directory, if a tile is created in that directory its group 
ID will be set to the effective group ID of the process that created the tile. This is 
the behavior exhibited by non-4.2BSD systems, including System V. If the set- 
GID bit is set on a directory, if a tile is created in that directory its group ID will 
be set to the group ID of the directory. This is the behavior exhibited by 4.2BSD 
and SunOS releases prior to 4.0. 

If a directory is created, its set-GID bit is set if the set-GID bit was set in the 
directory in which it was created. 

All directories that are part of the SunOS 4.0 release have the set-GID bit set. By 
default, the behavior for tiles created in those directories, or directories created 
under those directories, will be the same as the behavior in previous releases. 
Directories in existing tile systems do not have this bit set, so the default 
behavior for tiles created in those directories changes. 

When you install SunOS 4.0, do one of the following: 
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o Use the find command to find all directories in those file systems and turn 
the set-GID bit on for those directories. 

□ Mount the file systems with the grpid mount option that specifies that the 
4.2 BSD behavior should be exhibited for all newly-created files in direc¬ 
tories in that file system, regardless of the setting of the set-GID bit. 

The make command is enh^ced. It is upwardly compatible with System V 
make, and the following additional features: 

□ Hidden dependency checking 
o Conditional macros 

□ Pattern-matching implicit rules 

For more information, see Programming Utilities and Libraries. Appendix B is 
a summary of enhancements; Chapter 8 is a tutorial for using the SunOS 4.0 ver¬ 
sion of make. 

SunOS 4.0 directory entries are returned in a new format. The associated 
changes for the new directory entry format have been made in the kernel, user 
libraries, and include files. The changes to directory entry format include the fol¬ 
lowing: 

o A new d_of f field has been added to the directory-entry structure. This 
field is a cookie that is only interpretable by the filesystem type that gen¬ 
erated it. The d_of f field contains the offset of the next entry in the direc¬ 
tory. The only valid use for it in a user program is as an argument to 
1 seek (2) to seek to the next entry in a directory. 

□ The new directory entry format is contained in 

/usr /include/sys/dirent. h, a new include file. The name of the 
stmcture in this file has been changed from struct direct to 
struct dirent. A second new include file, 

/usr/include/dirent. h contains the directory information relevant 
to the C library directory (3) routines and the 
/usr/include/sys/dirent. h file. These two new files supersede 
the /usr/include/sys/dir. h file. 

□ The /usr/include/sys/dir,h file remains in SunOS 4.0 and has a 
new directory entry structure including the d_of f field. The struct 
direct name is retained. This allows programs which used the C library 
directory (3) routines and the /usr/include/sys/dir .h file to 
re-compile and run under SunOS 4.0 without modifications to the source 
code. 

□ The vnode/VFS interface routine, vn_readdir (), now returns direc¬ 
tory entries in the new format. 

□ A new system call, getdents (2), supersedes getdirentries (2) 
and returns directory entries in the new format, getdirentries (2) 
returns directory entries in the old format and can not be used with the 
/usr/include/sys/dir. h file, getdirentries (2) remains in 
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Does This Affect You? 


New Terminal Driver 


SunOS 4.0 to preserve binary compatibility. It wiU be removed in a future 
major release. 

□ The C library directory (3) routines have been modified to use the new 
directory entry format contained in /usr /include/sys/dirent. h 
and the get dents (2) system call. 

□ Some directory entry changes are transitional to preserve compatibility 
across releases. The getdirentries (2) system call and the 
/usr/include/sys/dir. h file are of this nature. 

The possible affects of the directory entry changes to your environment include 
the following; 

o If you have a pre-4.0 binary which uses the getdirentries (2) system 
call and/or the directory (3) library routines, your binary should con¬ 
tinue to run correctly without re-compilation under SunOS 4.0. 

□ If you have a program that currently uses the directory (3) library rou¬ 
tines and the /usr/include/sys/dir. h file, your source should com¬ 
pile and run correctly without changes under SunOS 4.0. 
/usr/include/sys/dir. h will be removed in a future major release, 
so you should plan to convert your program to use 
/usr/include/dirent.h. 

□ If you have a program that currently uses the getdirentries (2) sys¬ 
tem call and the file /usr/include/sys/dir. h, you must convert it 
to use the getdent s (2) system call and the 

/usr/include/sys/dirent, h file so it will run under SunOS 4.0. 
Note that the writing of programs that directly use the system call is emphat¬ 
ically discouraged. If possible, it is recommended that programs use the 
directory (3) library routines. 

NOTE The filesystem-independent directory entry format was formerly identical to the 

Berkeley 4.2 directory entry format defined in 

/usr/include/uf s/f sdir. h. With the new directory entry format, this is 
no longer the case. Code which relies on this identity between the two directory 
entry formats must be modified. 

A new terminal driver is incorporated into SunOS 4.0. It fuUy supports the func¬ 
tionality specified in the System V Interface Definition, as well as aU the func¬ 
tionality of the old V7/4BSD terminal driver. The exceptions to this are the 
LTILDE mode and the delayed suspend character. The new driver uses the Sys¬ 
tem V Release 3 STREAMS mechanism. 

As such, the driver permits the character size to be set to 5,6,7, or 8 bits per 
character, with or without a parity bit. It supports a full 8-bit data path when 8 
bits per character is selected. It does not strip off the 8th bit on output, and can 
be told not to strip off the 8th bit on input. 

If a terminal supports an 8-bit character set, it can be operated in 8 bits, no parity 
bit mode. The V7/4BSD compatibility features do not work correctly unless the 
character size and parity specifications are 7 bits plus a parity bit, or 8 bits and no 
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parity bit. Other settings, such as 5 or 6 bits per character, or 8 bits and a parity 
bit, should only be used in specialized programs talking to devices that require 
those settings. They should not be used for regular login terminals. 

If you want to use a terminal that supports 8-bit characters, set the terminal 
modes to a mode that supports an 8-bit data path. E)o this with the stty 
pass 8 command, or use the p 8 capability in /etc/gettytab. This also 
applies to terminals where the 8th bit is controlled by a meta key. EMACS 
correctly operates in this mode. It turns raw mode on and off correctly, leaving 
the 8-bit data path in place regardless of whether raw mode is on or off. 

If you are logged into a machine and have not set the terminal driver to have an 
8-bit data path, you cannot use rlogin to log into another machine and set the 
terminal driver on that machine to have an 8-bit data path. You must set the 8-bit 
data path on the first machine you log in to. You can then set it on all other 
machines you log in to. 

PASS 8 mode does not strip off the 8th bit on output as it did in SunOS releases 
prior to 4.0. 

The stty (IV) command is updated to print and set aU new modes. 

The following additional functionality is available in the pseudo-tty driver: 

□ If the baud rate is set to 0 with an ioct 1, all subsequent I/O on the con¬ 
troller gives an EIO error, just as if the slave side had been closed. This is 
analogous to setting the baud rate to 0 on a real terminal. The DTR drops 
and causes the other end to hang up. The EiO is normally treated as a sig¬ 
nal to the process on the controller side to exit. 

This can cause programs that carelessly get terminal modes, without check¬ 
ing whether the ioct 1 fetching the modes succeeded, and then set the ter¬ 
minal modes on a pseudo-terminal from the modes they fetched, to fail. If 
the fetch fails, the mode structure into which the modes were to be fetched 
contains the previous values. This may be initialized or uninitialized gar¬ 
bage (this was the case in 3.x also). If the baud rate value is 0, this causes all 
subsequent I/O on the controller to get an EIO error. 

□ Asynchronous I/O is supported on pseudo-tty controllers. The controller 
must be put into asynchronous mode using the F_SETFL f cnt 1 () call 
or the FIOASYNC ioctl() call. The process group to which the con¬ 
troller belongs must be set with the F_SETOWN fcntlO caUorthe 
FIOSETOWN ioctlO call. 

NOTE: For backwards compatibility, the TIOCSPGRP ioctlO call on 
the controller sets the process group owner of the slave, not the controller. It 
should not be used here. 

o The number of pseudo-terminals can be configured without source code. 
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newgrp 


Non-blocking I/O 


Obsolescence Mechanism 


The newgrp command is a new command that changes the group ID. The 
group ID of the file is set to the user’s group ID. newgrp allows the user to 
change his group ID. 

In most cases, BSD semantics for group ID’s should be in effect and the group 
ID is inherited from the parent directory, newgrp is not required under these 
circumstances, newgrp is required if System V semantics are in effect. For 
more information, see the newgrp man page. 

Non-blocking I/O is now fully supported in both 4.2BSD-style and System V- 
style. Two separate flags are used to request the different forms of non-blocking 
I/O. The FNDELAY and FNBIO flags are defined if a program includes 
<f cnt 1. h>. FNDELAY selects 4.2 BSD-style non-blocking I/O and FNBIO 
selects System V-style. 

There are two versions of <fcntl.h>: one in /usr/include and one in 
/usr/5include. 

□ /usr/include defines 0_NDELAY as FNDELAY. 

□ /usr/Sinclude defines 0_NDELAY as FNBIO. 

If a program uses 0_NDELAY and is compiled with /usr/bin/cc it gets 
4.2BSD-style non-blocking I/O. If the same program is compiled with 
/usr/5bin/cc, it gets System V-style non-blocking I/O. 

0_NDELAY is no longer defined in <sy s/ f ile. h>. Programs that use 
0_NDELAY must include <f cnt 1. h>. 

The /usr/old directory contains obsolete modules. Modules placed in this 
directory are subject to removal in future major releases. The following pro¬ 
grams have been moved to /usr/old in SunOS 4.0: 

□ filemerge 

An enhanced version is provided with the Network Software Environment 
(NSE) product. 

□ sunScvt 

This module was needed only for the transition to SunOS 3.0. 

□ compact, uncompact 

These modules are replaced by faster and more efficient, but incompatible 
compress and uncompress programs from 4.3BSD. 

□ eyacc 

This module was used to implement Pascal and has been removed in 
4.3BSD. 

□ make 

The pre-SunOS 3.4 version of make has been replaced. 
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Open Files Per Process 

Q1C24 PROM 


Do You Need a New PROM? 


o prmail 

This module has been replaced with mail -uin4.3BSD. 

□ pti 

This module has been replaced with troff -a in 4.3BSD. 

□ setkeys 

Input from default s (1) should be used instead. 

Also included in /usr/old: 

□ coretool 

□ perfmon 

□ setkeys 

o syslog (old version) 
a tektool 

□ ttytool 

□ VC 

Prior to SunOS 4.0, the limit was 30 open files per process. In SunOS 4.0, the 
limit is 64 open files per process. 

If you use Sun-3 software and 1/4" format tapes, this section describes the new 
1/4" tape format and how to check to see if your Sun-3 woikstation needs 
EPPROM’s to read the new format. 

To improve the quality of software distribution tapes and reduce software instal¬ 
lation time, the format of 1/4" cartridge tapes is changing for Sun-3 products. 
This change is incorporated in SunOS 4.0 and applies to software cartridge tapes 
for Sun-3,68020-based woikstations. 

Tape formats remain the same for Sun-2,68010-based software tapes and Sun-4 
SPARC-based software tapes. 

NOTE Sun-4 systems already use the new tape format. 

The following Sun-3 products that can be affected by the change in tape format 
include: 

□ Sun-3/50 

□ Sun-3/75 

□ Sun-3/260 (upgraded from a Sun-3/1 xx) 

□ Sun-3/60 
a Sun-3/160 



sun 

microsystems 


Revision A, of 9 May 1988 


20 SunOS™ 4.0 Change Notes 


If You Need a New PROM 


Signal Handlers 


□ Sun-3/280 (upgraded from a Sun-3/1 xx) 

Early revisions of the Sun-3 PROM’s do not understand the QIC24 tape format. 
Any system with a PROM of revision 1.8 or higher reads the new 9-track, QIC24 
tapes. To check the revision level of your PROM, use the following steps: 

1. Halt the system. 

For information on how to halt the system, see System Administration Manu¬ 
als Minibox. 

2. Type kb after the ">" prompt from the PROM monitor. 

If you have a revision of less than 1.8, install a newer revision of the PROM. 

If you load a QIC24 tape into a workstation that can only read QICl 1 tapes, you 
receive an 8 6A0 or 8 6A8 error from the controller. This error indicates that 
the controller was unable to read the header block of the tape. 

NOTE It is possible that this error is a result from a faulty tape. Check your PROM 
revision level, or test another tape. 

Upgrade PROM’s for Sun-3’s are available from Sun. If you have an On-site 
Hardware or Comprehensive Support contract. Sun will install the new PROM 
for you. If you are an on-site hardware support customer, phone the Sun 
Response Center at 800 USA-4-SUN and request Field Service to schedule your 
PROM installation. If you want to install the PROM yourself, call the 800 
USA-4-SIJN number, request Field Service, and ask for the Sun-3 PROM 
Upgrade Kit to be mailed to you. 

If you do not have an On-site or Comprehensive Support contract. Sun will mail 
you the Sun-3 PROM Upgrade Kit free of charge. The kit contains instractions 
for replacing the PROM chip on your CPU board, a process that takes about 10- 
15 minutes. Call the 800 USA-4-SUN number, request Field Service, and ask for 
a Sun-3 PROM Upgrade Kit. Sun will install the PROM’s for you, if you desire, 
and bill you for installation time only. 

Sun-3 systems that are upgraded with the latest version of the PROM continue to 
read QICl 1 tapes. The upgraded system reads all tapes produced before the 
upgrade. 


Functions that are specified as handlers for signals are now expected to be of type 
"function returning void", not "function returning int". This is the type 
specified by the current IEEE POSIX standard draft. Since no use is made of the 
return value of a signal handler, void is the correct type of such a function, not 
int. 

Code written assuming that these functions were of type int will continue to 
run and need not be recompiled. If this code is recompiled, it does not need to be 
changed, even though warning messages about type clashes will be printed. 

In addition, a number of signals provide and additional addr parameter to their 
handlers. This parameter describes a memory address relating to the exception 
condition indicated by the signal. For instance, SIGSEGV provides an addr 
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as the address reference that causes the signal to be delivered. Signals delivering 
an addr parameter include the following: 

□ SIGSEGV 

□ SIGBUS 

□ SIGFPE 

□ SIGEMT 

□ SIGILL 

Time Zones The handling of time zones has been upgraded. The following are now read from 

files: 

□ The offset difference of a time zone in relation to Greenwich Mean time. 

□ The rules that define when daylight savings time starts and ends. 

□ The amount of time change when daylight savings time starts and ends. 

□ The time zone names for standard and daylight savings time. 

By default, a file that contains the rules for the local time zone is used. If the TZ 
environment variable is set to the name of a file containing the rules for a dif¬ 
ferent time zone, that file is used instead; this applies to all utilities except 
selected ones, such as uucico, that must always use the local time zone. 

These files are generated from a textual description of the rules. The text files 
from which the distributed set of rule files are generated, and the command z ic 
used to generate them, are provided. 

New routines t imelocal and timegm are provided that convert a date and 
time, specified as month/day/year/hour/minute/second, from local or Greenwich 
Mean time respectively to the standard UNIX system date/time format. They 
perform the inverse of the conversion performed by the localtime and 
gmtime routines. These routines use the information from the appropriate time 
zone file; applications should not perform this conversion themselves. 

The structure returned by local time now contains extra fields that indicate 
the name and the offset from GMT of the current time zone at the time specified 
by the argument to localtime. 

The command t z se t up attempts to set the kernel’s notion of the offset from 
GMT and DST rule type based on the default time zone rules; this is done so that 
binaries built prior to 4.0 will run. In some cases, there is no set of DST rules 
that will work; if this is the case, t z se t up will indicate that DST is not 
observed. This program is run at boot time; there is no longer any need to 
specify the offset or DST rule type when building a kernel. 
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vacation 


ypset and ypbind 


8-bit Characters in Filenames 


System Call Changes 

close 


exec 


In SunOS 4.0, vacation is run with no arguments and now allows you to 
interactively turn it on and off. It creates a . vacation .msg file or allows 
you to edit an existing . vacation. msg file using the editor specified by the 
VISUAL or EDITOR environment variable. vi(l) is used if the environ¬ 
ment variables are not set. 

If a . forward file exists in your home directory, it asks whether you want to 
remove it and turn off vacat ion. If a . forward file does not exist in your 
home directory, it creates one for you and automatically performs vacation 
-I to turn on vacation. 

For more information, see Mail and Messages: Beginner’s Guide. 

In SunOS 4.0, the ypset and ypbind commands have greater security. You 
are no longer able to set the Yellow Pages server of the local or remote machines 
unless you have an effective UID of 0. 

The file system code has been changed to permit file names to contain characters 
with the 8th bit set. Previously, attempts to create or manipulate such files were 
rejected. Note that such files are impossible to remove using the C shell, as the C 
shell stiU uses the 8th bit to quote characters; the Bourne shell, which has been 
upgraded in 4.0, and now does not use the 8th bit to quote characters, must be 
used to remove these files. 

This section covers the system call changes and enhancements for SunOS 4.0. 

Prior to SunOS 4.0, a close on a descriptor on which an mmap had been per¬ 
formed resulted in an implicit munmap on the mapped pages. This has been 
eliminated in SunOS 4.0. Mappings remain established even after the descriptor 
from which they were obtained is closed. The only way to explicitly remove a 
mapping is through the munmap, exec, brk, and exit system calls. 

NMAGIC (0410) format executable files no longer have their shared text 
behavior. They still provide a write-protected text area for the program, but the 
memory used to hold that text is no longer shared with other processes running 
the same program. 

The parameter NCARGS, describing the number of characters which can be 
passed in the argument vectors to exec, has been greatly increased from 10240 
to 1048576 (1Mbyte). 

The default stack size for a new process has also been changed as a result of the 
NCARGS change, from .5 to 2Mbytes. 

The address space established by exec consists entirely of map_private 
mappings to the memory holding the program and stack (see mmap below). 
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fork 


getdents 


kill 


mincore 


mmap 


Prior to SunOS 4.0, fork copied the parent’s address space when creating a 
child. In SunOS 4.0, fork copies the mappings describing an address space not 
the address space itself, exec and other system operations specify 
MAP_PRIVATE mappings when address space objects are created. This 
behavior is completely compatible with previous releases in that changes made in 
parent and child are invisible to each other. 

For those applications which employ MAP_S HARED mappings to regular files 
(new in SunOS 4.0), a fork which copies such a mapping provides a means for 
parent and child to communicate through a shared memory region. 

A new System V compatible get dent s () system call has been added to read 
entries. As with the old get dirent riesQ system call, direct use of this call 
should be avoided. Use the directory(3) routines instead. 

The getdirentries 0 system call is still supported by the kernel in SunOS 
4.0. The C library interface for getdirentries () has been removed, how¬ 
ever. This means that pre-SunOS 4.0 binaries that are not invalidated by some 
other change and use getdirentries () should continue to mn. 

NOTE Source programs calling qetd 2 .xBnt.rLes {) must be converted to use get- 
dents. 

The kill system call now supports the System V rule for processes that are 
allowed to send signals to other processes. A process is now allowed to send a 
signal to another process in either of the following cases: 

□ The sending process has an effective user ID of super-user. 

□ The real or effective user ID of the sending process is equal to the real or 
saved set-user ID of the receiving process. 

This is a new system call to return the residency of pages mapped into an address 
space. 

The itimap system call is now fully implemented. In addition to character- 
special files such as frame buffers, programs can now map almost any random- 
access memory object into their address space via mmap. The most common 
usage is to map a regular file. 

File access through mapping is extremely efficient. The system can share multi¬ 
ple accesses with the same physical memory resources. The overhead involved 
in copying data via read and write is avoided with mapped files. Files can 
be mapped so that changes made by the mapping process are either invisible to or 
shared with others. 

File mapping is used as the basis for other system operations such as brk and 
exec. Other operations, such as fork have been respecified to deal with the 
new system structure. In these cases, the calls are completely backwards compa¬ 
tible. However, some behaviors are slightly different. These instances are noted 
elsewhere in this document as needed. 
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The programmer can use the whole address space supported by a processor. The 
program is no longer constrained to just the text, data, and stack segments form¬ 
erly provided by the system. These segments exist as conventions of the 
language tools rather than requirements of the system’s operation. As a result, a 
program is free to treat its address space as a simple vector of pages, each of 
which can be manipulated as an independent entity. 

Although itimap is compatible with pre-SunOS 4.0 binaries, to support the new 
functionality, and to be compatible with the system specification for Berkeley 
4.3BSD UNIX, the iranap system caU is source-code incompatible with previous 
releases of SunOS. This means that pre-SunOS 4.0 binaries that call mmapwill 
continue to run. However, sources containing a call to mmap must be changed 
to run correctly under SunOS 4.0. 

The changes to mmap include the following: 

□ The addr parameter was previously used to specify the location in the 
address space at which mapping was established. In SunOS 4.0, addr 
serves this purpose <?/i/y if the flag MAP_F IXED is included in the flags 
parameter of the caU. flags was previously called share. Without 
this flag, mmap determines the appropriate address for the mapping. 

□ The return value of a successful mmap is always the address at which the 
system placed the mapping, mmap should be declared as a function of 
type caddr_t. <sys/mman .h> takes care of this automatically. The 
only error return from a mmap call is the value ( caddr_t ) -1 . In partic¬ 
ular, code sequences of the following form used to check errors are not 
correct. 


if (mmap(...) < 0) 

V_^^^ 


mprotect 

msync 


O SYNC 


ptrace 


This is a new system call to change the access protections on memory mappings. 

This is a new system call to synchronize mapped addresses with their backing 
storage. 

The flag o_SYNC may be specified in the flags argument to open and 
font 1; if this flag is set on a file descriptor that refers to a regular file, all 
"write"s to that file will block until the data is completely written to disk. This 
happens regardless of whether the file is on a local file system or is being 
accessed over NFS. 

NOTE 0_SYliC has no ^ect on files accessed by using mmap. 

There are two new ptrace requests: 

□ PTRACE_SYSCALL which is used by the system call trace command 
/usr/bin/trace. 

□ PTRACE_DUMPCORE which is used by the /usr/ucb/gcore com¬ 
mand. 
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A restriction has also been removed on the PTRACE_DETACH request. It is no 
longer necessary for the process to be stopped. 

For more information, see the pt race (2) man page. 

The restrictions on the PTRACE_POKETEXT and PTRACE_writetext 
prohibiting the writing of shared text have been removed. 

select system call is upgraded to the 4.3BSD version. It now handles 
more than 32 file descriptors. Macros have been provided to manipulate sets of 
descriptors. 

truncate/ftruncate The truncate and f truncate calls now Berthe length of a file. These 

calls now allow you to extend a file, in addition to shortening it. 

utimes The ut imes system call now accepts a NULL pointer as its second argument 

If a NULL pointer is specified, utimes attempts to set the accessed and 
modified times on the specified file to the current time. You must either be the 
owner of the file or have write permission on the file for this command to 
succeed. 


General C Library Changes This section describes the changes in the general C library for SunOS 4.0. 

New hostent Structure Any programs that call gethostbyname, gethostbyaddr or gethos- 

tent need to be recompiled. The new hostent structure contains a list of 
addresses instead of just one. Many programs, however, only look at the first 
entry. 

printf () and scanf () The pr int f () routines now support the %i and %li format items; they are 

synonyms for %dand %ld. The scanf routines now support %i, %hi, 
%li,and %n. %i, %hi, and %li are similar to %d, %hd, and %ld, 

respectively, except that if the number being converted begins with "Ox" or "OX" 
it is assumed to be hexadecimal, and if the number begins with "0" it is assumed 
to be octal. % n returns the total number of characters that have been scanned so 
far by the current scanf caU. These are from the current ANSI C draft stan¬ 
dard. 

regexp The regexp regular-expression scanner has been upgraded to support the' V" 

and "\>" characters from vi. If a regular expression is enclosed in 'V" and 
’ V, it is constrained to match a "word"; the ’\<" must match the beginning of a 
"word", i.e. the beginning of a line or just before a letter, digit, or underline and 
after a character (not one of these), and the "N>" must match the end of a "word". 


2 . 5 . Graphics Software 
Changes 

The major changes and enhancements for SunOS 4.0 in graphics software are in 
the following products: 


GPSI 
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GPSI 

Pixrect 

pr_flip 0 

Pixrect Shared Library Facility 
SunCGI 

2.6. Diagnostics 

sysdiag 

ipctest and sunlink 


n Pixrect 

□ SunCGI 

In SunOS 4.0, GPSI supports the GP2 graphics accelerator and the CG5 color 
board. There is also a new set of macros that provide source code compatibility 
for GPSI application code between Sun3 and Sun4 architectures. 

Please refer to the GPSI Programmers Guide for more specific infoimation. 

The significant enhancements to Pixrect for SunOS 4.0 include: 

□ pr_flip() 

□ Pixrect shared library facility 

The use of the Intel 80386 processor by the Sun-386 products brings with it the 
issue of portability between different woricstation architectures. The Sun-386i is 
based on the 80386 processor, which handles byte ordering differently than the 
680X0 and spare processors used by other Sun workstations. 

pr_f lip () was added to Pixrect to facilitate portability across these different 
workstation architectures. See the Pixrect Reference Manual for more detailed 
information. 

Pixrect implements a shared library facility in SunOS 4.0. 

CGI was a proposed standard when SunCGI was written. CGI does not appear to 
be moving towards approval in the near term, while GKS, PHIGS, and CGM 
have been approved as standards. The process of transition to new standards 
means a phase-out of SunCGI in a future major release. This provides a transition 
period for customers to new software technology. 

SunCGI is fully supported in SunOS 4.0 and includes major bug fixes and a 
revised manual. See the SunCGI Reference Manual for more information. 

The primary changes to diagnostics in SunOS 4.0 are in sysdiag which is 
covered below. 

This section covers the changes in sysdiag for SunOS 4.0. 

In SunOS 4.0, sysdiag will not contain the ipctest or sunlink tests. 

The SunOS 4.0 versions of SunBPC, Sunlink Data Communications Processor 
(SCP), and Sunlink Multiprotocol Communications Processor (MCP) software 
required to test the system wiU not be available until after SimOS 4.0. 

The sysdiag tests are used to verify the functionality of the SunIPC, SCP, and 
MCP boards within the system. The ipctest and sunlink tests will be rein¬ 
tegrated into sysdiag at the earliest possible UNIX release. 


sun 

microsystems 


Revision A, of 9 May 1988 



Chapter 2 — SunOS 4.0 Change Notes 27 


pmem Test 

2 . 7 . Utilities 

etherfind 

file 

finger 


format 

geo re 

grep 

id 

install 

Idd 

Mail Transport System 


The pmem test on the SunOS 4.0 version of sysdiag should not be run on 
Sun-3/260 and Sun-3y280 systems. Instead, choose the Select Mode or Sin¬ 
gle Test Mode of sysdiag, not pmem test. 

This section covers the changes and enhancements to user-level commands and 
utilities that are incorporated into SunOS 4.0. 

The etherf ind program incorporates new options that print out more infor¬ 
mation that help in tracking down network problems, ether find also now 
understands Sim RPC headers. Refer to etherf ind (8). 

file has been enhanced to recognize dynamically linked objects and programs 
that require dynamic linking in order to execute. 

The finger command has changed so that it does not print entries for 
shelltool and cmdtool windows. It also determines the idle time for users 
logged in on the console from the idle time of /dev/kbdand /dev/mouse, 
so that meaningful results are diaplayed on workstations. In addition, it prints 
out the comment field for a terminal port’s entry in /etc /ttytab as the loca¬ 
tion of a user logged in on that port. 

format is a SunOS utility that allows you to format, label, repair and analyze 
disks on your Sun system. Unlike previous maintenance programs, format 
runs under SunOS. This offers a user friendly, menu based interface to disk 
maintenance. For complete instmetions on how to use format see System and 
Network Administration. 

The gcore command has a new -o flag that specifies the name of the core file. 
For more information, see the gcore man page. 

grep now uses the regexp package to interpret regular expressions, grep 
regular expressions are now compatible with those of ed. 

The id command now prints your group set, as well as real and effective user 
and group IDs. 

Prior to SunOS 4.0, install was a shell script. In SunOS 4.0, install has 
changed to a C program. For more information, see the install man page. 

List Djmamic Dependencies, Idd, is a new utility that reports the dynamically 
linked objects (generally shared libraries) on which an executable depends for its 
execution. 

This section covers the changes and enhancements to the mail transport system 
in SunOS 4.0. 
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Automatic Domain Configuration sendmail can use the domain name set in the kernel instead of having to 

modify each sendmail. cf file. 


En-or Message Improvements 


Inverted Alias Mapping 


Mail Exchanger Support 


Mailboxes on Servers 


mkdir 


Several minor improvements were made to the error messages generated by 
sendmail. For example, more messages fiom mailing lists are sent to the 
owner of the Ust instead of the sender of the message. 

A new mechanism is provided in sendmail that can rewrite an address 
through any Yellow Pages’ map. A new map is provided that contains the 
inverse of ±e mail. aliases map, so that mail going outside of a domain 
can be simplified. 

In addition to the normal version of sendmail that uses the YeUow Pages to 
resolve names, another version of sendmail is supplied in SunOS 4.0 that 
uses the domain name resolver directly. This version can be used on the Defense 
Data Network and to access Mail Exchanger (MX) records. 

Workstations can use NFS to mount mailbox directories from file servers. Out¬ 
going mail can be sent through the machine from which the mailbox directories 
are mounted. Typical diskless workstations should no longer need to run 
sendmail daemons. 

The mkdir command has a new -p flag to create parent directories. For more 
information see the mkdir man page. 


on Command Suspension Commands started with the remote execution service, the on program, can be 

suspended (for example, by typing I Control-Z I ) and continued. 

pst at pstat has been enhanced to print information about the queues for all active 

streams when the -S flag is specified. The -u flag has changed to take the pro¬ 
cess ID of the process whose area is printed out, rather than the address of that U 
area. 

SunOS 4.0 does not have shared text structures, therefore, the -x flag is not sup¬ 
ported. The ADDR and TEXTP fields are not printed when the -p flag is 
specified. Swap space allocation is reorganized in SunOS 4.0 and therefore, the 
information printed when the -s flag is specified is different. 

reboot The reboot command has a new -d flag to force a crash dump. It now pro¬ 

vides boot arguments. For more information, see the reboot man page. 

sed sed now uses the regexp package to interpret regular expressions, sed 

regirlar expressions are compatible with those of ed, and the \< and \> 
operators from vi are supported. 
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suninstall 


t ftp Defaults to Secure 


trace 


/usr/bin/troff 


/usr/pub/eqnchar 


2.8. New Security 
Features 


suninstall is the new installation tool replacing setup. It is a terminal 
based interface that provides a user-ftiendly installation editor which allows you 
to customize your systems and configurations. 

The trivial file transfer protocol should only be used to bootstrap machines over 
thenetworic. Use programs such as ftp or rdist to transfer other files. The 
default transfer mode to t f tp is now ASCII, so binary files need an explicit 
command. See tftp(l). 

trace is a new command that is a system call tracer. For more information, see 
the trace man page. 

The trof f command in SunOS 4.0 now supports PostScript™ printers instead 
of the CAT/4 phototypesetter. This is based on the assumption that the CAT/4 is 
obsolete. 

The following related modifications are incorporated in troff: 

□ The default font width tables now correspond to the Times Roman, Italic, 
and Bold fonts supplied with PostScript™. 

□ The maximum line length has been increased from 6 V 2 to 11 inches, which 
makes landscape mode usable. 

o The error message Typesetter busy has been changed to No 
/dev/cat: try -t or -a. 

The first modification means that users can produce output with trof f -t, then 
print quality documents with Ipr -t. Before, it was necessaiy to have Ti^- 
Script™ installed or remote mounted, and then to invoke ptrof f. 

Also, two ligature-related bugs in trof f were fixed. The first fix prevents the 
delayed interpolation of the f number register. The second fix avoids letters in 
the wrong font if a font change takes place in the midst of a ligature, when inside 
a diversion. 

The specially constructed mathematical symbols documented by eqnchar(7) 
are now optimized for PostScript™ printers, rather than for the CAT/4 photo¬ 
typesetter. The eqn symbols now defined in /usr/pub/eqnchar look best 
when used with old trof f and TranScript™ software. 

The following security enhancements have been incorporated into SunOS 4.0: 

□ Improved network security, with DES authentication of user and host, and 
public key cryptography. 

o An install-time option to run the system at a moderate level of security, pat¬ 
terned after the widely accepted C2 classification.! 


t Defined by the National Computer Security Center (a branch of the NSA), the CZcat^oiy adds passwoirf 

hiding and security auditing to the UNIX system. 
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To improve network security, a new set of RPC library routines offers DBS 
authentication to check the validity of both user ID and host address. Previously, 
UNIX authentication checked only the validity of user ID, which allowed users 
to impersonate each other over the NFS. 

To meet C2 specifications. Sun’s operating system was extended to provide 
improved password security, and flexible, fad-proof auditing of all events that 
affect security. Other extensions involve single-user booting, enhanced yellow 
page security, and stricter permission settings for system files. For more infor¬ 
mation, see Security Features Guide. 

NOTE While SunOS 4.0 should meet C2 specifications, Sun Microsystems does not 
intend to have the system actually certified as C2 secure. 


2 . 9 . System V 

Enhancements This section covers the enhancements to System V Release 3 in SunOS 4.0. 

New at and ciron The System V, Release 3 cron, at, and crontab utilities have been pro¬ 

vided. 

The form of the crontab file has not changed. Each user, however, can now 
have a crontab file so that jobs that run from that crontab file run with 
that user’s specified privileges. The crontab files are located in the directory 
/var/spool/cron/crontabs. The crontab file for a particular user 
carries the user’s login name as its file name. The standard system crontab file 
is owned by root. 

The crontab command is used to create, update, delete, and list crontab 
files. These files must not be edited directly, as cron does not reread them 
automatically. 

The at command is upwardly compatible with the previous version. However, 
it now supports more than one job queue. One queue that it supports is a "batch" 
queue; jobs submitted to this queue run "as soon as possible", at can be told to 
limit the number of jobs that run simultaneously in any particular queue. This 
queue can be used to limit the number of simultaneous background jobs running 
on the system. 

The set of users that can use cron and crontab, or at, can be restricted by 
the system administrator. By default, all users can use either cron or at. 

For more infomiation, see System and Network Administration and Doing More 
with SunOS: Beginner’s Guide. 

curses/terminfo The curses library and terminfo database have been upgraded to the Sys¬ 

tem V, Release 3.1 versions. This version fixes many bugs, and is faster and 
more compact than the previous version; it also includes many new capabilities. 
It supports eight-bit character sets. 


^sun 

Xr microsystems 


Revision A, of 9 May 1988 



Chapter 2 — SunOS 4.0 Change Notes 31 


ed 


sh 


The /usr/5bin/ed and /bin/ed commands have been merged into one 
version of ed that is compatible both with the 4.3BSD and the System V, 
Release 3.0 ed, with one exception: if the % character appears by itself in the 
replacement string of an s command, it restores the replacement string used in 
the previous s command. 

If ed scripts containing s commands with a single % as the replacement string 
are changed by putting a backslash before the %, they work in all known ver¬ 
sions of ed. If the % is not the only character in the replacement string, it has 
no special meaning and the command need not be changed. 

. x . . . . . . . .. ..^ 

For example, the following command: 
s/#/%/ 

Should be changed to: 
s/#// 

The following command does not need to be changed: 
s/60 percent/60%/ 


ed now uses the regexp package to interpret regular expressions and supports 
the \< and \> operators from vi. 

The new version of ed returns a non-zero exit status if an error occurs. An 
attempt to run ed on a non-existent file is considered an error. In this case, ed 
returns a non-zero exit status if a file name argument is specified and the file does 
not exist. This condition can affect Makefiles and shell scripts. A non-zero exit 
status can cause the make operation or shell script to terminate. 

ed did not previously return a non-zero exit status under any circumstances. To 
work around the new condition, modify the affected Makefiles and shell scripts 
to ignore the exit status of ed. 


NOTE 


A 


The shell has been upgraded to the System V, Release 3.1 version. This version 
no longer uses the 8th bit of a character to quote that character, so that it can han¬ 
dle command names and arguments containing characters with the 8th bit set. 

The new shell includes the get opts built-in command, which supercedes the 
getopt command, getopt is stiU provided, getopts is preferred, how¬ 
ever, as it corrects several inadequacies of getopt. 

The getopt cvt command can be used to convert shell scripts to use 
getopts. 

getopts is only supported by the System V Release 3 Bourne shell. Scripts 
that must also work on systems using the System V Release 2 Bourne shell, 
including SunOS releases prior to 4.0, should continue to use getopt. 
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stty 


System V STREAMS 
Interface 


2.10. Lightweight 
Processes 


The stty coimnand is now derived fioni the System V, ReleEse 3 version, to 
support the new terminal driver. When the terminal modes are printed, they are 
different from the modes printed by the 3.x stty command. Most of the mode 
settings supported by the 3.x stty command, such as cbreak, are still sup¬ 
ported by Ae 4.0 stty command. 

STREAMS is a facility with a set of tools for development of UNIX system com¬ 
munication services from networking protocol suites to individual device drivers. 

STREAMS defines standard interfaces for character I/O within the UNIX kernel, 
and between the kernel and the rest of the UNIX system. STREAMS consists of 
a set of system caUs, kernel resources, and kernel utility routines. STREAMS is 
not limited to a specific network architecture. STREAMS offers the following 
major features: 

□ Buffer management 

□ Flow control 
D Scheduling 

□ Multiplexing 

o Asynchronous operations of STREAMS and user processes 
There is a new STREAMS-based tty driver. 

There is a STREAMS-based Network Interface Tap (NTT). The old provisional 
socket-based facility has been replaced by a set of STREAMS modules and 
drivers that collectively provide a superset of the old versions functionality. A 
major enhancement is the addition of a packet filtering module that makes select¬ 
ing relevant packets out of all incoming packets much more efficient. 

For information on implementing STREAMS drivers and modules, see Part III 
of Writing Device Drivers. For information on implementing STREAMS appli¬ 
cations, see Programming Utilities and Libraries. 

The 4.0 lightweight process library provides primitives for manipulating threads 
of control, as well as for managing events (interrupts and traps). It is an excellent 
abstraction for implementing service processes which must maintain state for 
multiple connections, and for programs which manage asynchrony. At present, 
there is no kernel support for lightweight processes, so concurrent system calls 
must be implemented by forked UNIX processes. 

The fimctions supported by the library include the following: 

□ Thread creation, destruction, status gathering, priority manipulation, sleep¬ 
ing, suspension and resumption. It is possible to implement your own 
scheduler as a lightweight process. For example, a high priority Iwp can 
implement time-slicing for lower priority Iwps by periodically waking up to 
reshuffle the lower priority Iwp queues. The clock is multiplexed, so many 
threads can sleep concurrently for different time intervals. 
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o Individualized context switching (e.g., it is possible to specify that a given 
set of threads will touch floating point registers and only those threads wiU 
context switch these registers). 

□ Monitors and condition variables to synchronize threads. 

□ Extended rendezvous (message send-receive-reply) for communication 
between threads. 

o An exception handling facility that provides both notify and escape excep¬ 
tions. 

□ A way to map interrupts (asynchronous signals) into extended rendezvous. 

□ A way to map traps (synchronous signals) into exceptions. 

□ Utilities to allocate red-zone-protected stacks, and to provide some stack 
integrity checking for environments that lack sophisticated memory manage¬ 
ment. 

o A non-blocking I/O library is available that simulates the effect of con¬ 
current system calls by using asynchronous, non-blocking I/O. 

For more information, see the Lightweight Processes Tutorial in System Services 
Overview. 

2.11. Programming This section covers the changes and upgrades incorporated in the programming 

Environment environment in SunOS 4.0. 

Changes and 
Upgrades 

C Compiler Changes The following are changes and enhancements to the C compiler: 

D Has an "opaque pointer" type of void * which is conformable with any 
other pointer type. It may be assigned to or from any other pointer type 
without a warning. 

□ Does not accept "old-fashioned initialization" and "old-fashioned assign¬ 
ment operators" in the language. 

o Treats enum types as integral types. 

□ Accepts the new -pic option. 

The new -pic option instructs the compiler to generate position-independent 
code (PIQ. PIC is used to improve the memory utilization performance of 
dynamically linked programs, such as shared libraries. Code generated as PIC 
uses indirect references to access global objects, such as global data or functions. 
These indirect references are slower as a result of the extra indirection. 

NOTE A program that makes many indirect rTerences over a bri^period of time may 

see a performance degradation if compiled with the -pic option. 

The C preprocessor has been upgraded to support the #elif control line from 
the proposed ANSI C standard. It now predefines spare on the Sun-4. Anew 
command option -B causes it to handle the C++ comment indicator " / / ". This 
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symbol, and everything after it on a line, is treated as a comment. 

Changes to as The assemblers now accept a new flag, -k, which informs the assembler that the 

source module is written in a position- independent manner. When assembling 
with -k, the assembler issues different relocation information for the link edi¬ 
tors. More importantly, however, the assembler interprets some operating syntax 
differently than when -k is not specified, -k is primarily intended to assemble 
code produced by compilers that generate code appropriate for the new syntax 
interpretation. 

See, Assembly Language Reference for more information. 

Changes to Debuggers adb and dbx have been enhanced to handle the incremental appearance of pro¬ 

grams through dynamic linking. Both can be used with dynamically linked pro¬ 
grams. 

NOTE dbx cannot be used on the dynamically linked objects themselves. This is a res¬ 
triction in SunOS 4.0 and will be removed in a future release. 

Changes to lint lint incorporates the above changes from the C compiler. The enum as 

integral type change is only enabled if the -q flag is specified. 

The new version takes the new flags -target=/<?o and -host=6ar where/oo 
dSidbar are restricted to spare, mc68020, mc68010. Both -host and 
-target default to the machine type that you are on. For portability help 
between Sun-3’s and SPARC systems, specify -host=mc68020 if you are 
r unn ing on a SPARC system or -target=spare if you are running on a 
Sun-3. These flags are for specific portability between these machines and should 
not be used with the -p flag. 

In addition, lint performs the following functions: 

□ Detects and flags different alignment of structure members between Sun-2 
C, Sun-3 C, and SPARC C (when host and target are different). 

□ Detects and flags possible alignment problems on stmeture-pointer coer- 
sions. The old version assumed all stmeture pointers to have the same align¬ 
ment. 

O Treats long type as int, and unsigned long as unsigned int 
(if -q is specified). 

□ Treats a 0 supplied as a parameter value as being conformable with any 
pointer, if -q is specified. 

□ Issues a better message, when using the -x flag, about external declarations 
in . h files. The previous version could not figure out the file name, and 
printed ??? in its place. 

□ Allows /*VARARGS0*/. The old version treated this as the absence of 
varargs. 

□ The preprocessor treats the empty comment, / * * /, just as it is treated by 
the C compiler. 
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2.12. SunView 

Enhancements 


SunOS 4.0 incorporates substantial changes in the SunView user interface that 
were introduced with SimOS 3.0 and refined in subsequent 3.x releases. This 
section describes the enhancements made to SunView in SunOS 4.0. 


Summary of New SunView The main features SunOS 4.0 introduces to SunView include the following; 

Features from Release 3.4 , w.x . . 

□ cmdt ool(l) supports vi, more, man, su, and other programs that use 

“raw” mode and full-screen terminal mode. 

a You request menu Stay_up in def aultsedit(l) and it will be set as the 
default. This allows you to click the right mouse button and bring up a 
menu. The displayed menu remains displayed until you click the right 
mouse button again. 

Pull-right Menus are Now The default style is now the puU-right (walking) menu style introduced in SunOS 
the Default 3.0. 

You can set the default style back to stacking menus by disabling 

Walking Menus in the SunView category of defaultsedit(l): however, other 

menu defaults have no effect with old-style menus. 


New Text Menu The menu shown below in the text has been expanded and reorganized. Many 

tools use the Text window textedit(l), cmdtool(l), mailtool(l) and 
dbxtool(l). 

The Text menu in command windows has an additional pull-right menu, cmd, 
‘Mode =>' which allows you to edit the transcript and disable the scrolling to 
enter the tty Mode. 


1 FI 1e 


_ 


Again 

D1splay 

Undo Last Edit 

Find 

Copy Undo All Edits ^ 

Extras 

Paste 



Cut 



Shou Clipboard =0^ 

>5 


Copy, then Posto 



Since the default value for SwtViewlWalldng_Menus has changed in 4.0, default sedit will always write out 
your choice for SunView/Walking^Menus. This forces tools that haven’t been recompiled for 4.0 to pick up the 
default behavior. 
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Text Menu Layout The new text menu is organized into several pull-right sub-menus, 

with “industry-standard” names; for example, ‘File,’ ‘Edit,’ ‘Display,’ and 
‘Find.’ All basic editing operations such as ‘Cut’ are available from the new 
menu, as well as from function keys and keyboard accelerators. The various 
flavors of ‘Save’ are available from the ‘File => Finishing Up’ pull-right menu. 

For more information, see SunView 1 Beginner’s Guide. 

Delimiter Matching A new item in the ‘Find’ pull-right menu is ‘Match Delimiter’. If you select a 

delimiter in the text window, and then choose this menu item, the selection will 
be extended to the matching delimiter. 

Miscellaneous Text Enhancements The miscellaneous text enhancements include the following: 

□ Word Wrap 

□ Find and Replace Pop-up Frame 

□ Field Delimiters 

The Change Line Wrap puU-right menu lets you change the way physical lines 
are displayed in a text window or command window. 

The Wrap at Word option splits lines at word boundaries when they are too long 
for the window. Pressing 1 Return I starts a new paragraph. This split does not 
change the way the file is saved. In the saved file, the text up to I Return I is one 
continuous line regardless of how it appears on the screen. 

Other options in this menu are Wrap at Character and Clip Lines. 

Find & Replace pop-up frames can be invoked from the Text menu. One text 
string can be replaced by another and you can replace the current string, the next 
string, or all occurrences of a designated string. 


Field delimiters in text windows have the following appearance: 



Any typing is placed between the field delimiters. 

For more information, see SunView 1 Programmer’s Guide. 


‘Extras’ Menu In SunOS 4.0, you can operate on the selection from a new ‘Extras=>’ puU-right 

menu. The default ’Extras=>’ menu in /usr/lib/ . text_extras_menu 
includes filters to ‘Format’, ‘Capitalize’, ‘Shift Lines’, ‘Insert Brackets’, 
‘Remove Brackets’, and ‘Pretty-print C’. These work the same way as FILTER 
keys in your .textswrc file. 

You are encouraged to create your own ‘Extras=>’ menu. See SunView 1 
Beginner’s Guide for information on to create this menu. 

The text extras file i? re-read every time you bring up the Text menu. Once you 
create it, you can change it while running tools. The changes are immediately 
displayed in the ‘Extras=^>’ puU-right menu. 
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Find and Replace Pop-Up 
Frame 


Keyboard Control of the 
Caret and Editing 


Alerts 


If you select ’Find’ or its first pull-right item, ’Find=> Find and Replace’, a small 
pop-up frame is displayed. Type in the text string you want to find, and a text 
string (optional) to replace it. The following buttons are included in the ’Find 
and Replace’ menu; 

□ I Find I 

□ [ Replace 1 

□ I Find then Replace I 

□ 1 Replace then Find I 

o I Renlace All I 

o [ Etone 1 

□ I Blink Owner I 

For more information, see SunView 1 Beginner’s Guide. 


There are new enhanced keyboard accelerators for caret movement and menu 
actions such as editing. For more information, see the "All About Accelerators" 
chapter in the SunView 1 Beginner’s Guide. 

Various errors, warnings and queries now appear in pop-up alert windows. The 
Alerts package replaces a previous utility that displayed boxed error messages. 

For more information, see SunView 1 Beginner’s Guide and SunView 1 
Programmer’s Guide. 


Shadowed Frames and 
Menus 


File Size Limit on Editing 
Logs 


Key Mapping 


The shadow under an alert that indicates it is a transient window also appears 
under pop-up frames (frames with ‘Done’ in their menu instead of ‘Qose’). 

All shadows are now opaque. 

In SunOS 4.0, you can set a bound on the size of the edit log in cmdtool by set¬ 
ting the defaults entry Text_wraparound_size in the Tty category of 
def ault sedit. You can also set it using the command line option for 
cmdtool -M maximum/minimum size. 

For more information, see SunView 1 Programmer’s Guide. 

This enhancement lets you remap keys so that they perform other operations. 
There is no keymap unless you ask for it, by specifying aKeymapFile in the 
Input category of default sedit. 


New mailtool SunOS 4.0 has a new version of maiItool with many enhancements. To pro¬ 

vide backwards capability, you can change back to the previous version of mail- 
tool by turning off the options in the Mail category of default sedit and res¬ 
tarting mailtool. 

The new version of mailtool has the following enhancements: 
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□ A simplified control panel with fewer button items. 

□ Multiple composition windows each with its own reply control panel. 

□ Separate mail composition window for each message, 
o A hierarchical folders menu with subdirectories. 

□ Input focus that automatically places the caret in the message composition 
window when composing or replying. 

□ Fields in outgoing messages are easier to fill. 

The new mailtool works with a new version of the Mail(l) program and 
quickly incorporates new mail into your mail file. 

mailtool no longer changes the selection in the header window, when you do 
a mailtool operation. 

hold is the default in mailtool pop-up composition windows. Mail that is 
read is not automatically moved to mbox, but is kept in your mailbox, hold is 
not the default for mail. 

When you read new mail, or switch to a folder, mailtool tells you the number 
of new, unread, and aeleted messages. 

Double-clicking on ‘New Mail,’ ‘Done,’ and ‘Folder’ buttons (i.e., the time- 
consuming operations) results in only one invocation of the selected operation. 
Additional attentions made before completion of the selected operation are 
ignored. 

Specifying the font to be used in the tool via the -font or -wt command line 
argument now woiks correctly. 

If you edit the header line of a received message, the header window is updated 
to show the new header when you move to another message. 

For more information, see Mail and Messages: Beginner’s Guide. 

8-Bit Support in 

shelltool and 
cmdtool 

NOTE 


Underlining and Inverse in 

shelltool 


In conjunction with the new tty driver and Bourne shell in SunOS 4.0, 
cmdtool, shelltool, and the tty window package (used in cmdtool in 
‘Disable Scrolling’ mode and in shelltool) support 8-bit characters, also 
known as extended character sets. 

Most of the fonts in /usr/lib/f onts/f ixedwidthfonts do not have 
characters defined above hexadecimal 0x7F;yoM can use fontedit(7) to add 
another 128 glyphs to each. 

The tty window package used to use the 8th bit in its character memory to deter¬ 
mine if a character was to be displayed in bold or not. The change to support 8- 
bit characters described above also allows the tty window code to support three 
graphic rendition modes: 
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Table 2-2 Tty Display Modes 


Mode 

Escape 

Sequence 

termcap 

Name 

Description 

standout 

Esc [ 7m 

SO 

This is the same mode 
that the tty window supported 
before. It displays by inverting 
characters if Tty!Standout Jdode is 
enabled in defaultsedit . 

underline 

Esc[4m 

US 

This displays by 
underlining characters, if 

Tty Hinder line Mode is enabled 
in defaultsedit. 

bold 

(extra-bright) 

Esc [ Im 

md 

This is the mode whose 
visual representation is controlled by 
the Tty/Bold_style setting in 
defaultsedit 

all other graphic 
rendition display 
modes 

Esc [nm 

— 

These display 

the same as bold (extra-bright) 


The two new capabilities have been added to the sun entry in termcap(5). 

When there was only one graphic rendition mode, the tty window displayed 
everything in that mode — any kind of character highlighting would show up in 
your chosen Boldjstyle (default inverse video). Now that there are three dif¬ 
ferent modes, some things that used to display in your chosen bold style will now 
display inverted or underlined. In fact, “bold (extra-bright)” mode is rarely used, 
and this is the mode that you can change to many different styles by setting 
Tty/Bold_styleindefaultsedit. 

You can get the old behavior by setting Tty/ Inverse_mode and 
Tty/Underline_mode to Same_as_bold in defaultsedit. Also, if 
you need further control over what gets displayed in the different modes, you can 
modify t ermcap (5) . 


Frame Menu Changes 


‘Props’ Item in the Menu There is a ‘Props’ item in the frame menu, corresponding to the I Props) key (by 

default (L3 ] ) on the keyboard. In applications that have a property sheet (for 
example, the optional canvas_demo program) the ‘Props’ menu item displays 
the property sheet. In other applications, ‘Props’ is grayed out. Unbundled 
applications and future tools use property sheets. 
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Other Name Changes ‘Hide’ is renamed ‘Back’ and ‘Expose’ is renamed ‘Front.’ 

The I Left I and I Right I keys are renamed "Meta"(4) keys. 

[ Get I . (Put I . and 1 Delete 1 are renamed I Copy 1 . 1 Paste 1 . and I Cut I respectively. 

Unconstrained Move and Resize In the Frame menu, the default (top-most menu item in the pull-right menu) for 

‘Move’ and ‘Resize’ is now ‘Unconstrained.’ 


Other Sun View Changes 

Files Renamed 


New SunView “Root” Menu 


These changes are of interest to current SunView users. 

The program you run to start SunView has been renamed sun view (although 
typing suntools stiU works). The file in which you store your start-up tool 
positions has been renamed . sunview, to parallel the new program name. Sun¬ 
View looks for a . suntools file when it starts up, however, if it cannot find a 
. sunview file. 

clocktool has been renamed to clock. 

The default “root” menu is displayed when you bring up a menu over the back¬ 
ground pattern has been changed. The old menu is still available on 
/usr / lib/ . rootmenu. old. You can stiU create your own SunView menu 
file, ■/ .rootmenu. 


SunView Changes Visible 
to the Programmer 

Alerts The new alert package used throughout the new SunView tools is documented in 

the 4.0 version of the SunView Programmer’s Guide. 


More File Descriptors 


Lines in Menus 


Props Attribute 


Shadowed Frames 


The 4.0 kernel supports more than twice as many file descriptors per process, so 
applications are less likely to run out of windows. 

You can put lines in menus in SunOS 4.0 using the 
MENU_LINE_AFTER_ITEM attribute. This takes a value of either 
MENU_HORIZONTAL_LINE or MENU_VERTICAL_LINE . If yoU create an 
item with the MENU_LINE_AFTER_ITEM attribute, there wiU be a line 
between it and the next menu item; if you create a menu with 
MENU_LINE_AFTER_ITEM, then the entire menu has vertical or horizontal 
lines after items. 

You can use the new frame_PROPS_ACTION_proc to specify a function to 
be called when the user chooses the ‘Props’ frame menu item, or hits the I Props I 
key. 

A new boolean frame attribute, FRAME_SHADOW, controls whether frames have 
shadows or not. You set this attribute at the time of creating the frame; thus it 
can be used in window_create () and window_get (), but not in 
window set (). 
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All subframes (frames owned by another frame, with ‘Done’ in their menu) have 
shadows by default. 

Sun View Incompatibilities The new SunView features such as the new text menu are a dramatic improve¬ 
ment over their Release 3.X counterparts. However, many customers are 
affected by any change in the SunView user interface, usually because they have 
screendumps and instructions in documentation that assume the old SunView 
“look.” If you are such a customer, this section lists all the changed areas and the 
steps you can take to ensure visual compatibility with the past 
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Table 2-3 SunView User Interface Changes 


Change 

defaultsedit Work-Around 

Walking menus are 
the default 

Set SunViewlWalking_Menus 
to Disabled 

New text menu 

Set CompatibilityINewJText_Menu 
to Disabled 

New frame menu 

Set CompatibilitylNew_Frame_Menu 
to Disabled 

Alerts replace 
“menu prompt” 

Set Compatibility!Alerts 
to Disabled 

New keyboard 
accelerators 

Set ConyjatibilityINew_keyboard_accelerators 
to Disabled 

New root menu 

Set SunView!Rootmenu JUename 
to /usr/lib/rootmenu.old 

Many new 
mailtool features 

Set Compatibility!New_Mailtool Jeatures 
to Disabled 

New tty menu 

Set Compatibility!New_Tty_Menu 
to Disabled 

Standout and 

Underline Modes 

Set Tty!Standout_Mode 
to Same_as_bold 

Set Tty!Underline_Mode 
to Same as bold 


2.13. PROM Changes Due to Sun-4’s new, RISC based architecture, the Boot PROM-based power-up 

for Sun-4 self-tests are slightly different, as shown in the Installation Notes for the Sun 

Architecture 4200 Board Set, and in the PROM User’s Manual. These differences show up 

only on the CPU Board LED display and on a dumb terminal attached to Serial 
Port A during a diagnostic boot-up. 

Some PROM monitor commands were introduced to support the Sun-3/200 
series during UNIX Release 3.2, and are also used to support Sun-4/xxx worksta¬ 
tions. Commands such as i, j and n supported cache memory on Sun-3/2xx 
workstations and will now support Sun-4 cache memory. 
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Changed Commands 


Deleted Commands 


The d command now dumps the state of the processor instead of opening a CPU 
data register. 

The h (help) command now provides a more extensive user interface, described 
in the PROM User’s Manual. 

The r command, which previously displayed MC68020 registers, now displays 
SF9010 processor registers. Optional arguments are available for displaying 
floating point, global or special registers. You can also specify a register nmnber 
to display a particular register. These registers may be observed after an unex¬ 
pected trap or after a program or the user has aborted into the monitor. 

The s command now sets Address Space Identifiers for the SF9010 processor, 
rather than Function Codes for the MC68020. 

The X command provides, through a centralized diagnostic interpreter, a new 
user interface to the same extended tests that appeared in Sun-3 firmware.. This 
Extended Test System provides more comprehensive tests than the 
power-up self-tests, yet resides in the Boot PROMs. Rather than stepping 
through a menu hierarchy, you may now enter multiple commands from 
any menu to select tests and set test options. The PROM User’s Manual 
describes the new command line options. 

All other PROM monitor commands remain the same for this release. 

The a and t commands are not present in the Sun-4 PROM monitor. 
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